package com.xiaozhu.exception;

import lombok.extern.slf4j.Slf4j;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.validation.FieldError;
import org.springframework.web.bind.MethodArgumentNotValidException;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;

import java.util.HashMap;
import java.util.Map;

/**
 *  新增：全局异常处理器
 * 
 * 作用：统一处理所有Controller层抛出的异常，避免在每个Controller中重复编写try-catch
 * 
 * 处理的异常类型：
 * 1. MethodArgumentNotValidException - Bean Validation 验证失败
 * 2. IllegalArgumentException - 业务参数校验失败
 * 3. RuntimeException - 运行时异常
 * 4. Exception - 其他未知异常
 * 
 * @author 朱慧军
 * @version 1.0
 */
@RestControllerAdvice  // 声明全局异常处理器
@Slf4j
public class GlobalExceptionHandler {
    
    /**
     *  处理 Bean Validation 参数验证异常
     * 
     * 当 Controller 方法参数上的 @Valid 验证失败时触发
     * 例如：ChatDto 的 type、prompt、chatId 验证失败
     * 
     * @param ex 验证异常对象
     * @return 返回验证失败的字段和错误信息
     */
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ResponseEntity<Map<String, String>> handleValidationException(
            MethodArgumentNotValidException ex) {
        
        // 收集所有验证失败的字段和错误信息
        Map<String, String> errors = new HashMap<>();
        ex.getBindingResult().getAllErrors().forEach(error -> {
            String fieldName = ((FieldError) error).getField();
            String errorMessage = error.getDefaultMessage();
            errors.put(fieldName, errorMessage);
        });
        
        log.warn("参数验证失败: {}", errors);
        return ResponseEntity.badRequest().body(errors);
    }
    
    /**
     *  处理业务异常（参数校验）
     * 
     * 例如：手动抛出的 IllegalArgumentException
     * 
     * @param ex 异常对象
     * @return 返回错误信息
     */
    @ExceptionHandler(IllegalArgumentException.class)
    public ResponseEntity<Map<String, String>> handleIllegalArgumentException(
            IllegalArgumentException ex) {
        
        log.warn("业务参数异常: {}", ex.getMessage());
        
        Map<String, String> error = new HashMap<>();
        error.put("error", ex.getMessage());
        
        return ResponseEntity.badRequest().body(error);
    }
    
    /**
     *  处理运行时异常
     * 
     * 例如：数据库操作失败、Redis 连接失败等
     * 
     * @param ex 异常对象
     * @return 返回错误信息
     */
    @ExceptionHandler(RuntimeException.class)
    public ResponseEntity<Map<String, String>> handleRuntimeException(RuntimeException ex) {
        
        log.error("运行时异常: {}", ex.getMessage(), ex);
        
        Map<String, String> error = new HashMap<>();
        error.put("error", "操作失败: " + ex.getMessage());
        
        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(error);
    }
    
    /**
     *  处理所有未捕获的异常（兜底）
     * 
     * @param ex 异常对象
     * @return 返回通用错误信息
     */
    @ExceptionHandler(Exception.class)
    public ResponseEntity<Map<String, String>> handleException(Exception ex) {
        
        log.error("系统异常", ex);
        
        Map<String, String> error = new HashMap<>();
        error.put("error", "系统错误，请稍后重试");
        
        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(error);
    }
}












